home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3s / vfwscanf.z / vfwscanf
Encoding:
Text File  |  2002-10-03  |  6.1 KB  |  131 lines
  1.  
  2.  
  3.  
  4. vvvvffffwwwwssssccccaaaannnnffff((((3333SSSS))))                                                      vvvvffffwwwwssssccccaaaannnnffff((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _vvvv_ffff_wwww_ssss_cccc_aaaa_nnnn_ffff_:::: _vvvv_ffff_wwww_ssss_cccc_aaaa_nnnn_ffff_,,,, _vvvv_wwww_ssss_cccc_aaaa_nnnn_ffff_,,,, _vvvv_ssss_wwww_ssss_cccc_aaaa_nnnn_ffff - convert formatted wide-character
  10.      input
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_aaaa_rrrr_gggg_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>
  16.      _iiii_nnnn_tttt _vvvv_ffff_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_FFFF_IIII_LLLL_EEEE _**** _rrrr_eeee_ssss_tttt_rrrr_iiii_cccc_tttt _ssss_tttt_rrrr_eeee_aaaa_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _**** _rrrr_eeee_ssss_tttt_rrrr_iiii_cccc_tttt _ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _vvvv_aaaa______llll_iiii_ssss_tttt _aaaa_rrrr_gggg_))))_;;;;
  17.      _iiii_nnnn_tttt _vvvv_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _**** _rrrr_eeee_ssss_tttt_rrrr_iiii_cccc_tttt _ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _vvvv_aaaa______llll_iiii_ssss_tttt _aaaa_rrrr_gggg_))))_;;;;
  18.      _iiii_nnnn_tttt _vvvv_ssss_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _**** _rrrr_eeee_ssss_tttt_rrrr_iiii_cccc_tttt _ssss_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _**** _rrrr_eeee_ssss_tttt_rrrr_iiii_cccc_tttt _ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _vvvv_aaaa______llll_iiii_ssss_tttt _aaaa_rrrr_gggg_))))_;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _vvvv_ffff_wwww_ssss_cccc_aaaa_nnnn_ffff reads from the stream _s_t_r_e_a_m.
  22.  
  23.      _vvvv_wwww_ssss_cccc_aaaa_nnnn_ffff reads from the standard input stream _s_t_d_i_n.
  24.  
  25.      _vvvv_ssss_wwww_ssss_cccc_aaaa_nnnn_ffff reads from the wide-character string *_s.
  26.  
  27.      Each function reads wide-characters, interprets them according to a
  28.      format, and stores the results in its arguments.
  29.  
  30.      The _vvvv_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))), _vvvv_ffff_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))) and _vvvv_ssss_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))) functions are the same as
  31.      _wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))), _ffff_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))) and _ssss_wwww_ssss_cccc_aaaa_nnnn_ffff_((((_)))) respectively, except that instead of
  32.      being called with a variable number of arguments, they are called with an
  33.      argument list as defined by <stdarg.h>.
  34.  
  35.      These functions do not invoke the va_end macro.
  36.  
  37. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  38.      The following example shows the use of the vfwscanf function.
  39.  
  40.           #include <stdarg.h>
  41.           #include <stdio.h>
  42.           #include <wchar.h>
  43.  
  44.           void input(wchar_t *format, ...);
  45.           {
  46.                va_list args;
  47.                va_start(args, format);
  48.                vfwscanf(stdin, format, args);
  49.                va_end(args);
  50.           }
  51.  
  52. NNNNOOOOTTTTEEEESSSS
  53.      These functions are supported in n32 and 64 bit C Libraries for IRIX
  54.      6.5.18 and later versions as one of C99 features.
  55.  
  56.  
  57.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. vvvvffffwwwwssssccccaaaannnnffff((((3333SSSS))))                                                      vvvvffffwwwwssssccccaaaannnnffff((((3333SSSS))))
  69.  
  70.  
  71.  
  72. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  73.      _ffff_wwww_ssss_cccc_aaaa_nnnn_ffff(3S), _ssss_tttt_dddd_aaaa_rrrr_gggg(5), _ssss_tttt_dddd_iiii_oooo(3S), _wwww_iiii_dddd_eeee_cccc(3S).
  74.  
  75. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  76.      These routines return the number of successfully matched and assigned
  77.      input items; this number can be zero in the event of an early matching
  78.      failure between an input character and the control string.  If the input
  79.      ends before the first matching failure or conversion, _EEEE_OOOO_FFFF is returned.
  80.  
  81.      In addition, all forms of fwscanf() may fail if:
  82.  
  83.      [EILSEQ]
  84.           Input byte sequence does not form a valid character.
  85.      [EINVAL]
  86.           There are insufficient arguments.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.